home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / tcp_ip / docs / cmdshlp8 / ppp < prev    next >
Encoding:
Text File  |  1996-06-23  |  9.5 KB  |  267 lines
  1.  
  2. ppp
  3.  
  4.  
  5. The 'ppp' commands are used for Point to Point Protocol
  6. interfaces.
  7.  
  8. This implementation of PPP is designed to be as complete as
  9. possible.  Because of this, the number of options can be rather
  10. daunting.  However, a typical PPP configuration might include the
  11. following commands:
  12.  
  13.         attach asy 0x3f8 4 ppp pp0 4096 1500 9600
  14.         dial pp0 dialer.pp0 30 3 <remotehost>
  15.         #
  16.         ppp pp0 quick
  17.         ppp pp0 lcp open active
  18.         #
  19.     #Note: if remote assigns you a dynamic IP addr, you may need this cmd:
  20.     ppp pp0 ipcp local address none
  21.         ppp pp0 ipcp open active
  22.         #
  23.         ppp pp0 pap user authname authpasswd
  24.         # 
  25.         route add default pp0
  26.         #Note: if you are a Server, change 'open active' to 'open passive'
  27.         #      in two places, above, and also issue this command to force
  28.         #      clients to use pap:  ppp pp0 lcp local authenticate pap
  29.  
  30.  
  31. ppp <interface>
  32.   Display the status of the PPP interface.
  33.  
  34.  
  35. ppp <interface> quick
  36.   A quick way of issuing these commands:
  37.   ppp <interface> lcp local accm 0
  38.   ppp <interface> lcp local magic (misc_value)
  39.   ppp <interface> lcp local acfc on
  40.   ppp <interface> lcp local pfc on
  41.   ppp <interface> ipcp local compress tcp 16
  42.  
  43.  
  44. The following commands are used for the LCP (Link Control
  45. Protocol) configuration.
  46.  
  47. ppp <interface> lcp close
  48.   Shutdown the PPP interface.
  49.  
  50.  
  51. ppp <interface> lcp local ...
  52.   The 'lcp local' commands control the configuration of the local
  53.   side of the link.  If an option is specified, the parameters will
  54.   be used as the initial values in configuration requests.  If not
  55.   specified, that option will not be requested.
  56.  
  57.   For each of these options, the 'allow' parameter will permit the
  58.   remote host to include that option in its response, even when the
  59.   option is not included in the request.  By default, all options
  60.   are allowed.
  61.  
  62.  
  63. ppp <interface> lcp local accm [ <bitmap> | allow [on | off] ]
  64.   Display or set the ACCM (Async Control Character Map).  The
  65.   default is 0xffffffff.
  66.  
  67.  
  68. ppp <interface> lcp local authenticate [ pap | none | allow  [on | off] ]
  69.   Display or set the authentication protocol.  The default is none.
  70.  
  71.  
  72. ppp <interface> lcp local acfc [ on | off | allow [on | off] ]
  73.   Display or set the option to compress the address and control
  74.   fields of the PPP HLDC-like header.  This is generally desirable
  75.   for slow asynchronous links, and undesirable for fast or
  76.   synchronous links.  The default is off.
  77.  
  78.  
  79. ppp <interface> lcp local pfc [on | off | allow [on|off]]
  80.   Display or set the option to compress the protocol field of the
  81.   PPP HLDC-like header.  This is generally desirable for slow
  82.   asynchronous links, and undesirable for fast or synchronous
  83.   links.  The default is off.
  84.  
  85.  
  86. ppp <interface> lcp local magic [ on | off | <value> | allow [on|off] ]
  87.   Display or set the initial Magic Number.  The default is off
  88.  
  89.  
  90. ppp <interface> lcp local mru [ <size> | allow [on | off] ]
  91.   Display or set the Maximum Receive Unit.  The default is 1500.
  92.  
  93.  
  94. ppp <interface> lcp local default
  95.   Reset the options to their default values.
  96.  
  97.  
  98. ppp <interface> lcp open active | passive
  99.   Wait for the physical layer to come up.  If 'active', initiate
  100.   configuration negotiation.  If 'passive', wait for configuration
  101.   negotiation from the remote.
  102.  
  103.  
  104. ppp <interface> lcp remote ...
  105.   The 'lcp remote' commands control the configuration of the remote
  106.   side of the link.  The options are identical to those of the
  107.   local side.
  108.  
  109.   If an option is specified, the parameters will be used in
  110.   responses to the remote's configuration requests.
  111.  
  112.   If not specified, that option will be accepted if it is allowed.
  113.  
  114.   For each of these options, the 'allow' parameter will permit the
  115.   remote to specify that option in its request.
  116.  
  117.   By default, all options are allowed.
  118.  
  119.  
  120. ppp <interface> lcp timeout [<seconds>]                Default: 3
  121.   Display or set the interval to wait between configuration or
  122.   termination attempts.
  123.  
  124.  
  125. ppp <interface> lcp try ...
  126.   The 'lcp try' commands are used for the various counters.
  127.  
  128.  
  129. ppp <interface> lcp try configure [<count>]           Default: 10
  130.   Display or set the number of configuration requests sent.
  131.  
  132.  
  133. ppp <interface> lcp try failure [<count>]              Default: 5
  134.   Display or set the number of bad configuration requests allowed
  135.   from the remote.
  136.  
  137.  
  138. ppp <interface> lcp try terminate [<count>]            Default: 2
  139.   Display or set the number of termination requests sent before
  140.   shutdown.
  141.  
  142.  
  143. ppp <interface> ipcp ...
  144.   The 'ipcp' commands are used for the Internet Protocol Control
  145.   Protocol configuration.
  146.  
  147.   The 'close', 'open', 'timeout' and 'try' sub-commands are
  148.   identical to the LCP (described above).
  149.  
  150.  
  151. ppp <interface> ipcp local ...
  152.   The 'ipcp local' commands control the configuration of the local
  153.   side of the link.  If an option is specified, the parameters will
  154.   be used as the initial values in configuration requests.  If not
  155.   specified, that option will not be requested.
  156.  
  157.   For each of these options, the 'allow' parameter will permit the
  158.   remote to include that option in its response, even when the
  159.   option is not included in the request.  By default, all options
  160.   are allowed.
  161.  
  162.  
  163. ppp <interface> ipcp local address [ <hostid> | none | allow [on | off] ]
  164.   Display or set the local address for negotiation purposes.  If the
  165.   address "none" (or 0) is specified, the other side of the link will supply
  166.   the address.  By default, no addresses are negotiated.
  167.  
  168.  
  169. ppp <interface> ipcp local compress [ tcp <slots>
  170.              [<flag>] | none | allow [on | off] ]
  171.   Display or set the compression protocol.  The default is none.
  172.  
  173.   The tcp <slots> specifies the number of "conversation" slots,
  174.   which must be 1 to 255. (This may be limited at compilation time
  175.   to a smaller number.)  A good choice is in the range 4 to 16.
  176.  
  177.   The tcp <flag> is 0 (don't compress the slot number) or 1 (OK to
  178.   compress the slot number).  KA9Q NOS can handle compressed slot
  179.   numbers, so the default is 1.
  180.  
  181.  
  182. ppp <interface> ipcp pool [<address> [<count>]]
  183.   The ipcp pool command is used to display or set a range (or pool)
  184.   of consecutive IP addresses to be assigned to the PPP peer hosts.
  185.   <count> defaults to 1.  Addresses are assigned from this pool
  186.   unless the username provided by the peer host is found in FTPUSERS,
  187.   is authorized, and contains an IP address (or equivalent hostname)
  188.   in the fifth field, that is, following the permissions field.
  189.   Note: this field format may vary for non-ppp-intended entries in
  190.   FTPUSERS.
  191.  
  192.  
  193. ppp <interface> ipcp remote ...
  194.   The 'ipcp remote' commands control the configuration of the
  195.   remote side of the link.  The options are identical to those of
  196.   the local side.  If an option is specified, the parameters will
  197.   be used in responses to the remote's configuration requests.  If
  198.   not specified, that option will be accepted if it is allowed.
  199.   For each of these options, the 'allow' parameter will permit the
  200.   remote to specify that option in its request.  By default, all
  201.   options are allowed.
  202.  
  203.  
  204. ppp <iface> pap ...
  205.   The 'pap' commands are used for the Password Authentication
  206.   Protocol configuration.
  207.  
  208.   The 'timeout' and 'try' sub-commands are identical to the LCP
  209.   (described above).  However, the terminate counter is unused.
  210.  
  211.  
  212. ppp <interface> pap user [ <username> [<password>] ]
  213.   Display or set the <username>.
  214.  
  215.   The <password> may also be set, but not displayed.
  216.  
  217.   When <username> is specified, but no password is supplied, the
  218.   FTPUSERS file is searched for the password.  <username> must have
  219.   the PPP_PWD_LOOKUP privilege bit set to allow the password to be
  220.   taken from the FTPUSERS file.   When a username- password pair is
  221.   unknown or rejected, a session will appear at the console to
  222.   prompt for a new username-password.
  223.  
  224.   When the username-password combination is verified on the remote
  225.   side of the link, the entry in the other system's FTPUSERS file
  226.   (provided the remote system runs Jnos, of course) must have the
  227.   PPP_ACCESS_PRIV privilege bit set, or the authorization attempt
  228.   is refused.
  229.  
  230. ppp <interface> trace [<flags>]
  231.   Display or set the flags that control the logging of information
  232.   during PPP link configuration.
  233.  
  234.   The flag values are:
  235.  
  236.   0:  No trace
  237.   1:  Basic trace
  238.   2:  General trace
  239.  
  240.   Values greater than 2 are usually not compiled, and are described
  241.   in the appropriate source files where they are defined.
  242.  
  243.  
  244. Here are some selected PPP reference documents:
  245. RFC:  TITLE:
  246. 1661  The Point-to-Point Protocol (PPP)
  247. 1663  PPP Reliable Transmission
  248.  
  249.  
  250. Here are some usage tips:
  251. 1.  The dialer need not be used, as ' comm pp0 "ATDT5551212" ' could
  252.     dial your ppp provider.  The dialer is of course much more flexible,
  253.     and is necesary when a dialog is required with the provider.
  254.  
  255. 2.  If your hostname from the ppp provider is dynamic (ie, it may
  256.     change as your assigned IP address changes), you can assigned it
  257.     dynamically in this fashion:   domain addserver <ip_addr>
  258.                                    hostname pp0
  259.     where you must replace <ip_addr> with the provider's DNS address.
  260.  
  261. 3.  When DCD drops, Jnos will drop DTR and RTS to the modem.  This may
  262.     prevent the modem from answering a callback by a remote ppp client,
  263.     unless RingIndicator (RI, pin 22) is wired between the modem and the
  264.     serial port.  A RI status will cause Jnos to do an automatic 'param UP'
  265.     so as to reassert DTR and RTS, and thereby allow the modem to answer.
  266.  
  267.